# How the diagnostics list works at run time

At run time, the Diagnostics list shows information about system activity, with a different icon for each type of message.

## Open the diagnostics list display

There are two ways to open the display containing the Diagnostics list:

- In the Diagnostics Setup editor, select one or more Open display automatically when options to make the application open the display whenever a new message appears. You can use the default [diagnostics] display or specify a graphic display you have created that contains a Diagnostics list.
- In a graphic display, create a goto display button that the operator can press to open the display containing the Diagnostics list.

The default display opens on top of the current display.

Tip: | If you are using your own graphic display containing the diagnostics list, in the Display Settings dialog box, make it an On Top display, and select the Cannot Be Replaced option. This means that, when a message occurs, your display will open on top of the current display, and will remain open until you close it.

## Use buttons with the diagnostics list

The application creates a default graphic display called [diagnostics] that contains a Diagnostics list and these buttons:

- Clear - clears the selected message. You can create this button in your own display using the Clear diagnostics button.

  If the button's Send press to property is set to Object With Focus, and the current object with focus is not a diagnostics list, the button press will have no effect.

  If the button's Send press to property is set to Linked Object, pressing the button will not change input focus to the linked diagnostics list. Whatever object has input focus on the display will continue to have input focus.

- Clear All - clears all messages. You can create this button in your own display using the Clear All Diagnostics button.
- Move Up - scrolls up in the list. You can create this button in your own display using the Move Up button.
- Move Down - scrolls down in the list. You can create this button in your own display using the Move Down button.
- Close - closes the graphic display containing the list. You can create this button in your own display using the Close Display button.

If you modify the default display or create your own graphic display containing a diagnostics list, the display might contain different buttons.

## See also

Create diagnostics lists

Use the MoveLeftButton and MoveRightButton to view diagnostic messages

Create Goto Display buttons

Create Diagnostics buttons